home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmPrintSetup.z / XmPrintSetup
Encoding:
Text File  |  2002-10-03  |  6.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmPPPPrrrriiiinnnnttttSSSSeeeettttuuuupppp((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmPPPPrrrriiiinnnnttttSSSSeeeettttuuuupppp((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmPPPPrrrriiiinnnnttttSSSSeeeettttuuuupppp - setup and create a Print Shell widget
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/Print.h>
  13.           WWWWiiiiddddggggeeeetttt XXXXmmmmPPPPrrrriiiinnnnttttSSSSeeeettttuuuupppp(
  14.           WWWWiiiiddddggggeeeetttt vvvviiiiddddeeeeoooo____wwwwiiiiddddggggeeeetttt,
  15.           SSSSccccrrrreeeeeeeennnn ****pppprrrriiiinnnntttt____ssssccccrrrreeeeeeeennnn,
  16.           SSSSttttrrrriiiinnnngggg pppprrrriiiinnnntttt____sssshhhheeeellllllll____nnnnaaaammmmeeee,
  17.           AAAArrrrggggLLLLiiiisssstttt aaaarrrrggggssss,
  18.           CCCCaaaarrrrddddiiiinnnnaaaallll nnnnuuuummmm____aaaarrrrggggssss);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           A function that does the appropriate setting and creates a
  25.           realized _X_m_P_r_i_n_t_S_h_e_l_l that it returns to the caller. This
  26.           function hides the details of the XXXXtttt to set up a valid print
  27.           shell heirarchy for the application. It is also meant to
  28.           encourage consistency in the way applications root their
  29.           print widget hierarchy.
  30.  
  31.           _p_r_i_n_t__s_c_r_e_e_n must belong to a Display connection that has
  32.           already been initialized with XXXXtttt.
  33.  
  34.           The _v_i_d_e_o__w_i_d_g_e_tis used to get at the application context,
  35.           application name and class, and aaaarrrrggggcccc////aaaarrrrggggvvvv stored on the
  36.           aaaapppppppplllliiiiccccaaaattttiiiioooonnnnSSSShhhheeeellllllll that roots this widget. If no
  37.           aaaapppppppplllliiiiccccaaaattttiiiioooonnnnSSSShhhheeeellllllll is found, NNNNUUUULLLLLLLL aaaarrrrggggvvvv////aaaarrrrggggcccc are used.
  38.  
  39.           XXXXmmmmPPPPrrrriiiinnnnttttSSSSeeeettttuuuupppp then creates an unrealized AAAApppppppplllliiiiccccaaaattttiiiioooonnnnSSSShhhheeeellllllllwith
  40.           the same name and class as the one given by the video
  41.           display, on the print display and on the print screen
  42.           specified.
  43.  
  44.           An _X_m_P_r_i_n_t_S_h_e_l_lis then created as a child of this toplevel
  45.           shell, using XXXXttttCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppSSSShhhheeeellllllll, with the name
  46.           _p_r_i_n_t__s_h_e_l_l__n_a_m_e, and using the _a_r_g_sprovided. It then
  47.           realizes and maps the print shell, using _X_t_P_o_p_u_p with
  48.           _X_t_G_r_a_b_N_o_n_e.
  49.  
  50.           This way, application resource files and users can specify
  51.           print specific attributes using the following syntax (if
  52.           pppprrrriiiinnnntttt____sssshhhheeeellllllll____nnnnaaaammmmeeee is "Print"):
  53.  
  54.           Dtpad.Print*textFontList: somefont
  55.           *Print*background:white
  56.           *Print*highlightThickness:0
  57.  
  58.           _v_i_d_e_o__w_i_d_g_e_t
  59.                     A video widget to fetch app video data from.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmPPPPrrrriiiinnnnttttSSSSeeeettttuuuupppp((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmPPPPrrrriiiinnnnttttSSSSeeeettttuuuupppp((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           _p_r_i_n_t__s_c_r_e_e_n
  75.                     A print screen on the print display - specifies
  76.                     the screen onto which the new shell is created.
  77.  
  78.           _p_r_i_n_t__s_h_e_l_l__n_a_m_e
  79.                     Specifies the name of the XmPrintShell created on
  80.                     the X Print server.
  81.  
  82.           _a_r_g_s      Specifies the argument list from which to get the
  83.                     resources for the XmPrintShell.
  84.  
  85.           _n_u_m__a_r_g_s  Specifies the number of arguments in the argument
  86.                     list.
  87.  
  88.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  89.           The id the _X_m_P_r_i_n_t_S_h_e_l_l widget created on the X Print Server
  90.           connection, or NULL if an error has occured.
  91.  
  92.      EEEERRRRRRRROOOORRRRSSSS////WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  93.           None.
  94.  
  95.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  96.           From the OOOOKKKK callback and the SSSSeeeettttUUUUpppp callback of the primary
  97.           print dialog widget:
  98.  
  99.           static void
  100.           printOKCB(Widget, XtPointer call_data, XtPointer client_data)
  101.           {
  102.             AppPrint *p = (AppPrint *) client_data;
  103.             DtPrintSetupCallbackStruct *pbs =
  104.                                    (XmPrintCallbackStruct *) call_data;
  105.  
  106.             /* connect if not already done.
  107.                the print dialog callback always provides valid
  108.                        printer name, print display and screen
  109.                        already initialized: XpInitContext called */
  110.            */
  111.             p->print_shell = XmPrintSetup (widget, pbs->print_screen,
  112.                                                         "Print", NULL, 0);
  113.  
  114.             ...
  115.           }
  116.  
  117.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  118.           XXXXmmmmPPPPrrrriiiinnnnttttSSSShhhheeeellllllll(3), XXXXmmmmRRRReeeeddddiiiissssppppllllaaaayyyyWWWWiiiiddddggggeeeetttt(3), XXXXmmmmPPPPrrrriiiinnnnttttTTTTooooFFFFiiiilllleeee(3),
  119.           XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMM(3)
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.